home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / lisp / clue.lha / clue / doc / clue.tex / node246_mn.html < prev    next >
Text File  |  1989-07-12  |  5KB  |  76 lines

  1.  
  2. <H3><A ID="SECTION006911100000000000000"><tex2html_anchor_invisible_mark></A> <A ID="ch:complete-names"><tex2html_anchor_mark></A><BR>
  3. Complete Names and Classes
  4. </H3><#5373#>
  5.            
  6.       
  7.  
  8. In order to access a contact resource value in a resource database, an
  9. application uses two items as a ``key'': a <#3439#><B>complete resource name</B><#3439#>,
  10. <A ID="3440"><tex2html_anchor_invisible_mark></A>
  11. <A ID="3441"><tex2html_anchor_invisible_mark></A>
  12. <A ID="3442"><tex2html_anchor_invisible_mark></A> 
  13. and a <#3443#><B>complete resource class</B><#3443#><A ID="3444"><tex2html_anchor_invisible_mark></A>. A
  14. contact's complete resource
  15. name and class are derived from the contact and its (current) ancestors. The
  16. complete resource name is a list of symbols of the form <#4728#><TT>(<#4524#><EM>name<SUB>1</SUB>
  17. ...name<SUB>n-1</SUB> name<SUB>n</SUB></EM><#4524#>)</TT><#4728#>, where <#4525#><EM>name<SUB>n</SUB></EM><#4525#> is the
  18. <#3449#><TT>name</TT><#3449#> of the contact, <#4526#><EM>name<SUB>n-1</SUB></EM><#4526#> is the <#3451#><TT>name</TT><#3451#> of
  19. the contact's <#3452#><TT>parent</TT><#3452#>, etc., and <#4527#><EM>name<SUB>1</SUB></EM><#4527#> is the <#3454#><TT>name</TT><#3454#> of the <#3455#><TT>contact-display</TT><#3455#> to which the contact belongs (see below).
  20. Similarly, a contact's complete resource class is a list of type symbols of the form
  21. <#4729#><TT>(<#4528#><EM>class<SUB>1</SUB>
  22. ...class<SUB>n-1</SUB> class<SUB>n</SUB></EM><#4528#>)</TT><#4729#>, where <#4529#><EM>class<SUB>n</SUB></EM><#4529#> is the
  23. class of the contact,<A NAME="tex2html399" HREF="footnode_mn.html#foot4530" TARGET="footer"><SUP>66.1</SUP></A> 
  24. <#4531#><EM>class<SUB>n-1</SUB></EM><#4531#> is the class of
  25. the contact's <#3462#><TT>parent</TT><#3462#>, etc., and <#4532#><EM>class<SUB>1</SUB></EM><#4532#> is the <#3464#><TT>class</TT><#3464#> of
  26. the <#3465#><TT>contact-display</TT><#3465#> to which the contact belongs <A NAME="tex2html400" HREF="footnode_mn.html#footfnm2" TARGET="footer"><SUP>66.2</SUP></A>.  Complete resource name and class lists thus have the same length. 
  27.  
  28. <P>
  29. The names of the resources used by a contact are defined by the contact class
  30. and are given by the resource specification list <A ID="3467"><tex2html_anchor_invisible_mark></A>
  31. in a <#3468#><TT>defcontact</TT><#3468#> form (see Section~<A HREF=<tex2html_cr_mark>#ch:defcontact#3469><tex2html_cr_mark></A>). Each such contact
  32. resource also has a complete resource name, defined to be <#4533#><TT>(append
  33. (contact-complete-name <#3470#><EM>contact</EM><#3470#>) (list <#3471#><EM>resource-name</EM><#3471#>))</TT><#4533#>. Similarly, the complete resource
  34. class of a contact resource is defined to be <#4534#><TT>(append
  35. (contact-complete-class <#3472#><EM>contact</EM><#3472#>)
  36. (list <#3473#><EM>resource-class</EM><#3473#>))</TT><#4534#>, where <#3474#><EM>resource-class</EM><#3474#> is given by the
  37. <#3475#><TT>:class</TT><#3475#> option of the resource specification.
  38.  
  39. <P>
  40. For all contacts that belong
  41. to a <#3476#><TT>contact-display</TT><#3476#>, the ``top-level'' complete resource name component
  42. is a resource name symbol associated with the <#3477#><TT>contact-display</TT><#3477#>. Since an application usually uses a single <#3478#><TT>contact-display</TT><#3478#>, this name is usually a symbol which identifies the
  43. application itself.  This name is given as the value of the <#3479#><TT>:name</TT><#3479#> keyword argument to the <#3480#><TT>open-contact-display</TT><#3480#> function. 
  44. <A ID="3481"><tex2html_anchor_invisible_mark></A>
  45. In addition,
  46. the <#3482#><TT>display-name</TT><#3482#> and <#3483#><TT>display-class</TT><#3483#>
  47. macros may be used to inquire  the name and class, respectively, of a
  48. <#3484#><TT>contact-display</TT><#3484#>.
  49.  
  50. <P>
  51. <#4730#>
  52. <#4535#><FONT SIZE="+1"><#3485#><B>display-name Macro, contact-display</B><#3485#></FONT><#4535#> 
  53. <A ID="3486"><tex2html_anchor_invisible_mark></A>
  54. <A ID="3487"><tex2html_anchor_invisible_mark></A>
  55. <DIV class="RIGHT">
  56. <tex2html_image_mark>#tex2html_wrap_inline10527#
  57. </DIV><#4730#>
  58. <DIV class="RIGHT">
  59. <tex2html_image_mark>#tex2html_wrap_inline10530#
  60. </DIV>
  61.  
  62. <P>
  63. <#4731#>
  64. <#4538#><FONT SIZE="+1"><#3498#><B>display-class Macro, contact-display</B><#3498#></FONT><#4538#> 
  65. <A ID="3499"><tex2html_anchor_invisible_mark></A>
  66. <A ID="3500"><tex2html_anchor_invisible_mark></A>
  67. <DIV class="RIGHT">
  68. <tex2html_image_mark>#tex2html_wrap_inline10531#
  69. </DIV><#4731#>
  70. <DIV class="RIGHT">
  71. <tex2html_image_mark>#tex2html_wrap_inline10534#
  72. </DIV>
  73.  
  74. <P>
  75.  
  76.  =0 <#5383#>=0 <#5387#>